home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / ziptv21.zip / ZIPTV.DOC < prev    next >
Text File  |  1990-04-22  |  8KB  |  247 lines
  1.   
  2.   
  3.                                  Z i p   T V
  4.   
  5.                             Version 2.1, 04-22-90
  6.  
  7.                     Online .ZIP Directory/Text View Module
  8.               for .ZIP files made with PKZIP092 through PKZIP102
  9.   
  10.                                  ZIPTV21.ZIP
  11.   
  12.           Copyright 1989, 1990 Samuel H. Smith;  ALL RIGHTS RESERVED
  13.   
  14.   
  15.                         This program is supported by:
  16.   
  17.                               The Tool Shop BBS
  18.                                  Phoenix, AZ
  19.                         (602) 279-2673 (2400) - Free node
  20.                         (602) 264-3969 (HST 9600)
  21.                         (602) 279-0230 (Hayes V9600)
  22.   
  23.   
  24. 'ZIPTV' is a small zipfile text-view utility.   It allows you to
  25. directly list out text files in a ZIP file without first extracting
  26. them.  This version includes full source code and is compatible with
  27. network filesharing. Run ZIPTV without parameters for a summary of
  28. command syntax.
  29.  
  30. This utility can be used as a simple DOOR in systems that can provide a
  31. valid filespec for zipfile viewing.
  32.  
  33. This utility is compatible with PKware PKZ090.EXE, PKZ092.EXE,
  34. PKZ101.EXE and PKZ102.EXE file formats.
  35.  
  36. Source code is included.  Some additional library files are required.
  37. Look for TOOL-INC.ZIP and TOOL-USE.ZIP from The Tool Shop BBS.
  38.  
  39.  
  40. USAGE
  41. =====
  42.  
  43.    ZIPTV [-Pport] [-Tminutes] [-Llines] [-Mlines] [drive:\path\]FILE[.zip]
  44.  
  45.    -Pn   Enables com port COMn and monitors carrier.
  46.          Local operation allowed with -P0.
  47.  
  48.    -Tn   Allows user to stay in program for n minutes.
  49.          The default is 10 minutes.
  50.  
  51.    -Ln   Specifies lines per page in 'more?' prompts.
  52.          The default is 23 lines per page.
  53.  
  54.    -Mn   Specifies maximum number of lines of viewing to allow per session.
  55.          The default is 500 lines per session.
  56.  
  57. Example PCBVIEW.BAT for PCBoard 14.0  (dos 3.3 and later)
  58. ------------------------------------
  59.    @ziptv -p1 %1 >pcbview.txt
  60.  
  61.  
  62. Example PCBVIEW.BAT for PCBoard 14.0  (dos 3.2 and earlier)
  63. ------------------------------------
  64.    echo off
  65.    ziptv -p1 %1 >pcbview.txt
  66.  
  67.  
  68. Example PROD.CNF for ProDoor 2.9  (2-18-89 and later)
  69. --------------------------------
  70.    ; Archive manipulation commands
  71.    ;  list members, text to stdout, xtract file to file, test, rearc
  72.    ZIPtv -p$N$ -t$TIME$
  73.    pkunZIP -c >$R$
  74.    proxZIP >$R$
  75.    pkunZIP -t >$R$
  76.    prorarc $R$
  77.    .ZIP has errors!
  78.  
  79.  
  80. Example PRO-R.BAT for ProDoor 3.0 and later
  81. -------------------------------------------
  82.    :zip
  83.    chkpath ziptv %0 >>%3
  84.    if errorlevel 1 goto end
  85.    ziptv -p%1 -t%2 >>%3 %4
  86.    if errorlevel 1 goto error
  87.    goto end
  88.  
  89.  
  90.  
  91. ENVIRONMENT VARIABLES
  92. =====================
  93.  
  94.    Ziptv uses BIOS calls to perform all display updates.  The program
  95.    attempts to automatically detect EGA 43 and VGA display modes so it
  96.    can adapt as needed.  Unfortunately, under some environments these
  97.    BIOS enquiries cause the program to freeze.  To avoid this, you may
  98.    need to add the following environment variable before first running
  99.    ziptv:
  100.         SET OVCRT=ON
  101.  
  102.    Ziptv has the ability to access non-standard COM ports.    To use com
  103.    ports other than the normal COM1 and COM2, you can now insert the
  104.    following statements in your batch file:
  105.         SET COMBASE=nnnn        ;port base I/O address (decimal)
  106.         SET COMIRQ=n            ;port IRQ setting
  107.  
  108. REVISION HISTORY
  109. ================
  110.  
  111. 2-16-89
  112.    Initial alpha test release.
  113.  
  114. 3-5-89
  115.    First fully operational release; should correctly unzip all
  116.    compression methods.  First public release of source code.
  117.  
  118. 3-14-89
  119.    Added code to detect local operation.  If A -p1 or -p2 parameter is
  120.    provided, but carrier is not present when the door initializes, it
  121.    will assume "local mode via PCBoard" and will disable the carrier
  122.    check.  This should allow sysop access to ZIPTV via pcboard's F V
  123.    function.  If a caller is online and drops carrier just as ZIPTV
  124.    loses carrier, the program will time out and recycle the board after
  125.    the time specified in the -T parameter.
  126.  
  127. 4-7-89
  128.    Corrected time-left calculation when crossing over midnight.
  129.  
  130. 7-18-89
  131.    Added automatic support for EGA 43 line screen modes.
  132.    Added partial support for dos version 2.
  133.  
  134. 9-1-89
  135.    Beta release supporting PKZ101 "implode" compression format.
  136.    Added -L option to control lines per page.
  137.  
  138. 9-9-89
  139.    Added support for non-standard COM port configurations.  To use
  140.    com ports other than the normal COM1 and COM2, you can now insert the
  141.    following statements in your batch file:
  142.         SET COMBASE=nnnn        ;port base I/O address (decimal)
  143.         SET COMIRQ=n            ;port IRQ setting
  144.  
  145.    Released as ZIPTV20.ZIP.
  146.  
  147. 1-30-90
  148.    Added -M option to encourage users to download large text files
  149.    rather than viewing them entirely through ZIPTV.
  150.  
  151.    Added a check for the environment variable
  152.         SET OVCRT=ON
  153.    to disable EGA and VGA bios checks, which conflict with some
  154.    timeshare programs or with the BIOS in some PCs.
  155.  
  156.    Added a check to prevent viewing of encrypted zipfile members.
  157.  
  158.    Added additional error checking to prevent lockups when accessing
  159.    some corrupted or truncated zip files.
  160.  
  161.    Corrected operation in "local mode" when a -p1 or -p2 option is used,
  162.    but carrier is not present initially.
  163.  
  164. 2-4-90
  165.    Added logic to allow text files containing only NEWLINE (line-feed)
  166.    characters as used on Unix and unix-like systems.
  167.  
  168. 4-5-90
  169.    Added support for DSZ-compatible COM3 through COM8 built-in com port
  170.    definitions.
  171.  
  172.  
  173. LICENSE
  174. =======
  175.  
  176.    You may copy and distribute this program freely, provided that:
  177.        1)   No fee is charged for such copying and distribution, and
  178.        2)   It is distributed ONLY in its original, unmodified state.
  179.  
  180.    If you wish to distribute a modified version of this program, you MUST
  181.    include the source code.
  182.  
  183.  
  184.    SourceWare: What is it?
  185.    -----------------------
  186.  
  187.    SourceWare is my name for a unique concept in user supported 
  188.    software. 
  189.    
  190.    Programs distributed under the SourceWare concept always offer
  191.    complete source code.
  192.  
  193.    This package can be freely distributed so long as it is not modified
  194.    or sold for profit.  If you find that this program is valuable,  you
  195.    can send me a donation for what you think it is worth.  I suggest
  196.    about $10.
  197.  
  198.    Send your contributions to:
  199.       Samuel. H. Smith
  200.       5119 N. 11 ave 332
  201.       Phoenix, Az 85013
  202.  
  203.  
  204.    Why SourceWare?
  205.    ---------------
  206.  
  207.    Why do I include source code?  Why isn't the donation manditory?  The
  208.    value of good software should be self-evident. The source code is the
  209.    key to complete understanding of a program.  You can read it to find
  210.    out how things are done.  You can also change it to suit your needs,
  211.    so long as you do not distribute the modified version without my
  212.    consent.
  213.  
  214.  
  215.    Copyright
  216.    ---------
  217.  
  218.    If you modify this program, I would appreciate a copy of the new
  219.    source code.   I am holding the copyright on the source code, so
  220.    please don't delete my name from the program files or from the
  221.    documentation.
  222.  
  223.  
  224. SUPPORT
  225. =======
  226.  
  227.    I work very hard to produce a software package of the highest quality
  228.    and functionality.  I try to look into all reported bugs, and will
  229.    generally fix reported problems within a few days.
  230.  
  231.    Since this is user supported software under the SourceWare concept,
  232.    I don't expect you to contribute if you don't like it or if it
  233.    doesn't meet your needs.
  234.  
  235.    If you have any questions, bugs, or suggestions, please contact 
  236.    me at: 
  237.          The Tool Shop BBS
  238.        (602) 279-2673 (2400) - Free node
  239.        (602) 264-3969 (HST 9600)
  240.        (602) 279-0230 (Hayes V9600)
  241.  
  242.    The latest version is always available for downloading. 
  243.  
  244.    Enjoy!     Samuel H. Smith
  245.               Author and Sysop of The Tool Shop.
  246.  
  247.